home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 6 / MacMania 6.toast / / Tools&Utilities / Bernie ][ The Rescue / Warp4 / Bernie ][ The Rescue Docs < prev    next >
Text File  |  1997-04-25  |  31KB  |  450 lines

  1. Bernie ][ The Rescue Warp 4 (ß4)
  2. Release Notes
  3.  
  4. © 1996, 1997 F.E.Systems Horstmann & Gudat
  5. http://www.magnet.ch/emutech/
  6.  
  7.  
  8. 1. What is Bernie?
  9.      1.1 About This Public Beta
  10.      1.2 Shareware Notice
  11.      1.3 Registration
  12.      1.4 Protection
  13.  
  14. 2. Installation Procedure
  15.      2.1 Memory
  16.  
  17. 3. Working with Bernie
  18.      3.1 Keyboard
  19.      3.3 Function Keys
  20.      3.2 Mouse
  21.  
  22. 4. Starting Emulation
  23.     4.1 SpeedNanny
  24.  
  25. 5. Video Support
  26.      5.1 Bypassing QuickDraw
  27.      5.2 Power Mode
  28.      5.3 Smooth Mouse Tracking
  29.      5.4 Copying Text/Graphics
  30.  
  31. 6. Working With Disks
  32.      5.1 Formats Supported
  33.      5.2 Mounting Disk Images & Volumes
  34.      5.3 Rearranging the Device Chain
  35.      5.4 Unmounting/Ejecting a Volume
  36.      5.5 Booting
  37.      5.6 Creating New Volumes
  38.      5.7 Limitations of the CleverPort Disk Interface
  39.  
  40. 7. Ensoniq Sound Emulation
  41.      6.1 Recommendations
  42.      6.2 Limitations of Sound Emulation
  43.  
  44. 8. Miscellanous
  45.  
  46. 9. Contacting F.E.Systems - see separate document
  47.  
  48. See also "MUST READ • Volume Sharing" for important information on volume sharing.
  49.  
  50.  
  51. License Agreement
  52.  
  53. The Fine Print. This software and manual are sold "as is" without warranties as to perfomance and fitness to a particular purpose. Neither the authors of Bernie ][ The Rescue ("Bernie" hereafter) nor Kagi Shareware are liable or responsible for loss or damage caused directly or indirectly by this software product. The user, and not the manufacturer, distributor, or retailer, assumes the entire cost of all necessary repair, servicing or correction and any incidental or consequential damages.
  54. Copyright. Bernie is copyrighted and all rights are reserved by André Horstmann and Henrik Gudat ("F.E.Systems" hereafter). Bernie is shareware - you are encouraged to distribute Bernie by electronic means or on disks of 2Mb or less, provided that you do not modify or omit parts of the software and/or documentation. Distribution of Bernie on CD-ROM and all other high capacity (over 2MB) media is strictly prohibited without a prior written permission. If you have questions regarding this license agreement, would like to bundle Bernie on a CD-ROM or get a site license, please send e-mail to both andre.horstmann@mail-com.net and emutech@magnet.ch .
  55.  
  56.  
  57. What is Bernie?
  58.  
  59. Welcome to Apple IIgs emulation! Bernie is a Apple IIgs emulation software for Power Macintosh computers. With Bernie, you can run virtually all Apple II software (some restrictions apply) on your Power Macintosh. At time of this writing, Bernie is not compatible with pre-PowerPC Macs (680x0 family). We are looking into backward compatibility and hope to release a version that runs on Power Macs and fast 68030 and 68040-based Macintosh computers.
  60.  
  61. This documentation will tell you what all those controls are and what they do. For some of Bernie's house trainers this documentation was not sufficient, so we have upgraded our web space at http://www.magnet.ch/emutech/ : you will find FAQs and detailed instructions on basic procedures on our web.
  62.  
  63.  
  64. Shareware Notice
  65.  
  66. Bernie is shareware. We have really spent an incredible amount of time with this software. The price we have set does not reflect at all the tremendous amount of time we have dedicated to this project, but we have created Bernie because we love this machine and really enjoyed working on it. If you find our emulation software useful and/or appreciate our work, please support this shareware product and pay US $25. The shareware fee may increase slightly when the final version will be released. 
  67.  
  68.  
  69. Registration
  70.  
  71. If you hate reading long text, here's some information in compressed form:
  72.  
  73. • the unregistered Bernie will quit after 30 minutes and does not save Preferences to disk
  74. • registering is fairly simple. Please read the instructions below how to register.
  75. • when registering, please ensure your order form includes the serial stamp that is printed in the shareware notice
  76. • F.E.Systems offers fast and uncomplicated online support. We do not register or support through fax, phone or snail mail.
  77.  
  78. The unregistered version of Bernie has two limitations: it quits after running for 30 minutes and it does not write a Preferences file to disk. Except for that, the registered and unregistered versions have exactly the same functionality.
  79. To turn your copy into a registered version, you only need to pay the shareware fee. In order to make this process as simple as possible for you, F.E.Systems has signed up at Kagi Shareware, a company specialized in processing shareware fees. You can pay with credit card, check and cash. You will find a "Register" application in this archive that automates shareware payment. This Register application outputs an order form that you can fax (+1 510 652 6589), e-mail (shareware@kagi.com) or snail mail to Kagi Shareware along with your check, cash or credit card number. Do not forget to include your serial number. We need this code to unlock your copy. In the register program, there's a very small balloon to the left of the text "Bernie ][ by Andre Horstmann & Henrik Gudat" - if you click it, Register allows you to enter a comment. This is a perfect place to include your serial number in the order form.
  80.  
  81. Bernie has the following pricing.
  82. • 1-9 single user licenses, $25 per user
  83. • 10+ single user licenses, $20 per user
  84. • Site Licenses, World-Wide Licenses and special pricing for educational institutions are available. Please contact F.E. Systems directly (emutech@magnet.ch).
  85.  
  86. Paying for Bernie is fairly simple. Open the Register program that comes with Bernie. Enter your name, your email address, and the number of single user licenses you wish to purchase. Save or Copy or Print the data from the Register program and send the data and payment to Kagi. More specifics on the Register program to follow. Kagi handles our payment processing.
  87.  
  88. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number.
  89. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement.
  90.  
  91. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is:
  92.  
  93.           Kagi
  94.           1442-A Walnut Street #392-XF
  95.           Berkeley, California 94709-1405
  96.           USA
  97.  
  98. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical.
  99. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.
  100. Kagi can not invoice your company, you need to act on Kagi's behalf and generate the invoice and handle all the paperwork on your end.
  101.  
  102. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  103.  
  104.  
  105. Protection
  106.  
  107. Bernie has a protection scheme and when you pay, we tell you how to indicate to Bernie that you have paid the registration fee.
  108.  
  109. If your copy (previously registered) copy of Bernie suddenly reverts to unregistered state, contact F.E.Systems. (Please do not contact Kagi in such situations.) Please include your old registration code and the serial number displayed in the registration box. We will provide you with a new code. (At no charge, of course.)
  110.  
  111.  
  112. Validity of Your Registration
  113.  
  114. The license you buy from F.E.Systems is a "single installation" license, that means it will work on one particular system. We will switch to a less restrictive registration scheme in an upcoming beta update. If you have already registered Bernie, you will be notified automatically in e-mail and provided with a new code if applicable.
  115. When registering your current copy of Bernie, you are buying a license for all pre-1.0 betas and all versions 1.x of Bernie. We're not sure if there will ever be a version 2.0 - possibly not.
  116.  
  117.  
  118. Installation Procedure
  119.  
  120. Bernie comes as a self-expanding Compact Pro archive. To install Bernie, turn the BinHex file into a executable Macintosh file (you can use utilities such as StuffIt and CompactPro) and double-click the Bernie.cpt icon.
  121. Since Bernie is a software-only emulator, it requires a copy of the Apple IIgs ROM. We are not allowed to include this code due to the copyrights that prevent us from doing so. Consequently, you have to create an image of a Apple IIgs ROM yourself. Bernie can handle both ROM 1 and ROM 3.
  122.  
  123. You might find additional information about ROM images and other tools at http://www.emulation.net. These web pages are maintained by John Stiles and are an excellent source of information for all emulator-related matters.
  124.  
  125. ---- NOTE ----
  126. We have now included a small utility that will extract the ROM image for you. It is part of this archive and must be unshrinked first (on the IIgs).
  127. -----------------
  128.  
  129. For manually dumping the ROM, follow these simple steps:
  130.  
  131. • turn on your Apple IIgs and boot into Prodos 8
  132. • If you have a ROM 1 Apple IIgs enter the following text (do not enter the "]" and "*")
  133.         ]call -151
  134.         *0/800<FE/0.7FFFM
  135.         *BSAVE APPLE2GS.ROM,A$800,L$8000
  136.         *0/800<FE/8000.FFFFM
  137.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$8000
  138.         *0/800<FF/0.7FFFM
  139.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$10000
  140.         *0/800<FF/8000.FFFFM
  141.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$18000
  142.  
  143. • If you have a ROM 3 Apple IIgs enter the following text (do not enter the "]" and "*")
  144.         ]call -151
  145.         *0/800<FC/0.7FFFM
  146.         *BSAVE APPLE2GS.ROM,A$800,L$8000
  147.         *0/800<FC/8000.FFFFM
  148.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$8000
  149.         *0/800<FD/0.7FFFM
  150.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$10000
  151.         *0/800<FD/8000.FFFFM
  152.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$18000
  153.         *0/800<FE/0.7FFFM
  154.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$20000
  155.         *0/800<FE/8000.FFFFM
  156.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$28000
  157.         *0/800<FF/0.7FFFM
  158.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$30000
  159.         *0/800<FF/8000.FFFFM
  160.         *BSAVE APPLE2GS.ROM,A$800,L$8000,B$38000
  161.  
  162. • Copy the file APPLE2GS.ROM to a HFS disk (in the IIgs Finder).
  163. • Insert this disk into your Mac's disk drive and move the ROM image into the Bernie application directory.
  164.  
  165. CAUTION: DO NOT USE PC EXCHANGE! Various users have told us that PC Exchange makes the ROM image unusable.
  166.  
  167. •  Done!
  168.  
  169.  
  170. Memory
  171.  
  172. Bernie has a small memory footprint. The factory setting is approx. 4Mb RAM. This application size is about the equivalent of a 1.5Mb Apple IIgs system. (Ca. 2.5 megabytes are reserved for Bernie, all remaining free RAM will be allocated for Apple IIgs memory.) If you would like to increase available Apple IIgs memory, follow these steps:
  173.  
  174. • Make sure Bernie is not already running. If it is, choose Quit from Bernie's File menu.
  175. • Locate the Bernie application on your Mac and highlight its icon in the Finder window
  176. • Choose "Get Info" from the File Menu (in the Finder)
  177. • Enter a new application size in the "preferred" text box. Each additional 64 kB will translate into 64 additional kilobytes of Apple IIgs memory.
  178. • Close the window
  179.  
  180. The next time you start Bernie, the changes in memory allocation will take effect. Please keep in mind that Bernie will not allocate more than 8 megabytes for Apple IIgs memory.
  181.  
  182.  
  183. Working with Bernie ][ The Rescue
  184.  
  185. Bernie is a stratospherically easy-to-use application with a straightforward point & click interface.This documentation will show how certain procedures such as inserting/ejecting disks etc. work with Bernie. However, to learn more about how the Apple IIgs system software works, you should consult the manuals that came with your Apple IIgs. (You must own an Apple IIgs in order to legitimately use the ROM image.)
  186.  
  187.  
  188. Keyboard
  189.  
  190. Some keys have a different meaning:
  191.  
  192. • The Apple IIgs Reset key is the delete key on the Mac keyboard. The Mac's shutdown/startup key retains its original function. The delete key allows you to reset (control+delete) and reboot (control+command+delete) the system.
  193. • The keypad may not work as expected. If you are trying to type on the keypad and nothing happens, make sure you have disabled joystick emulation via the keypad. To turn it off, choose "Joystick Support/None" from the Setup menu.
  194. • To access Macintosh menu key commands, press command-shift-[key] instead of command-[key].
  195.  
  196. On slower Macs, you should consider enabling keyboard buffer in the Classic Control Panel (on the IIgs).
  197.  
  198. Function Keys
  199.  
  200. Bernie also supports function keys. The keys are reserved as follows:
  201.  
  202.   F1:     Undo (n/a)
  203.   F2:  Cut (n/a)
  204.   F3:  Copy
  205.   F4:  Paste
  206.  
  207.   F5:  Joystick toggle
  208.   F6:  Mouse toggle
  209.   F7:  Sound On/Off
  210.   F8:  PowerMode On/Off
  211.  
  212.   F9:   Speed Nanny On: 2.6 Mhz
  213.   F10: Slower
  214.   F11: Faster
  215.   F12: Speed Nanny Off
  216.  
  217.   Shift-F13: Power Off-On (Cold Reset)
  218.   Shift-F14: Shutdown (Quit)
  219.   F15:               Halt
  220.  
  221.  
  222.  
  223. Mouse
  224.  
  225. For most desktop based Apple IIgs applications, the mouse switching is done automagically by Bernie. However, if the application is not using the Event Manager to poll the mouse, you have to manually turn on mouse emulation to use it as an Apple IIgs mouse. There's an easy shortcut to swap between Mac and GS mouse: Command-shift-M.
  226.  
  227. Bernie is incompatible with the Kensington mouse driver and Apple II software that requires low-level mouse emulation. (This excludes most desktop applications - they will work fine.) You will notice jerky, unreliable mouse movement. Disable the Kensington extension before using Bernie.
  228.  
  229.  
  230.  
  231. Starting Emulation
  232.  
  233. As soon as Bernie is loaded, emulation is running. To pause emulation, choose "Halt" from the Setup menu.
  234.  
  235. SpeedNanny
  236.  
  237. New in Warp 4 is SpeedNanny, a tool for fine-tuning the speed at which Bernie is emulating. If SpeedNanny is turned off, Bernie is humming along at top speed, typically far beyond that of a stock IIgs. Here's how you can enable/disable SpeedNanny :
  238.  
  239. • choose the "SpeedNanny" menu item in the Setup menu. This will activate SpeedNanny and gives you the performance of a stock IIgs (2.6 Mhz). Choosing SpeedNanny again will turn it off again, thus you can toggle between stock IIgs and full speed by selecting the menu command or by pushing its key equivalent Shift-Command-Y. 
  240.  
  241. • open the "Speed" Window and move the slider. This slider allows you to choose a speed from anything within 0.8Mhz and 4Mhz in 0.2Mhz increments for very fine adjustments. If you move the slider to its topmost position, SpeedNanny will be disabled and the display will show "FULL".
  242.  
  243. You can control SpeedNanny via function keys as well. See the previous chapter ("Function Keys") for details.
  244.  
  245.  
  246. Video Support
  247.  
  248.  
  249. Bernie supports virtually all text, graphic and mixed modes. High resolution graphics (280x196) is monochrome only - this will change in the final release.
  250.  
  251. Bernie's super-hires emulation bases on indexed colors, the same color scheme the Apple IIgs is using. Due to the way how the Mac is handling colors you might want to deactivate a few palettes. Why? When reserving all colors for Bernie, you will notice that all background applications and Bernie windoids will be redrawn in black&white, or using only very few colors. Typically, you do not need all 14 palettes and can reduce the number of active palettes. By not enabling all 14 palettes you allow for better display of background application, desktop and Bernie auxiliary windows.
  252.  
  253. For example, when working with desktop applications, 1 to 8 palettes are sufficient. Note that activating more palettes does not have an impact on execution speed. Bernie offers you the possibility to cut back color support for cosmetic reasons only.
  254.  
  255. Bypassing QuickDraw
  256.  
  257. The beta 2 introduces a 'Bypass Quickdraw' option (see Preferences window, 'Video' section). Without this feature, Bernie is maintaining an off-screen copy of the current IIgs video and frequently copies this video image to the Video window.
  258. With 'Bypass Quickdraw' enabled, Apple IIgs software is drawing directly into the Video window which results in a noticeable increase in performance. If this option is active, the Video window is titled "Video" (instead of "Video (Slow)"). Note that direct screen updates are disabled if the Video window is overlapped by other windows!
  259.  
  260. Power Mode
  261.  
  262. But - that's not the whole story. Bernie features a special video mode called Power Mode. The Power Mode makes your Apple IIgs emulator look like an actual Apple IIgs. The Power Mode has the following characteristics:
  263. • your monitor will be set to 14" resolution (if possible)
  264. • the Video window will be centered and the space around the Video will be covered by a border
  265. • all 16 palettes will be activated for 100% reproduction of GS video. Remember, Bernie can only
  266.   display up to 14 palettes otherwise. The Power Mode takes over all available colors of your Mac.
  267. • operating in Power Mode yields better performance.
  268.  
  269. In Power Mode, all available colors are reserved for IIgs video. Unfortunately, this prevents Bernie from displaying the border in the proper color. Bernie allows you to put aside one color for the border (see video panel in Preferences). Of course, this one color will not be available in the video window and may result (in extremely rare situations) to cosmetic quirks. 
  270.  
  271. Another check box in the video panel, "Switch At Startup", makes Bernie go into Power Mode by default.
  272.  
  273. Yet another check box in the same video panel, "Fade Screen at Switch", introduces a supercool fade out/in while switching between normal (windowed) view and Power Mode.
  274.  
  275. To quit Power Mode push Command-Shift-P. You have to remember this keystroke because the menu is not visible. Alternately, you can use the function key F8 to enter or leave Power Mode.
  276.  
  277. Smooth Mouse Tracking
  278.  
  279. Bernie now features a fixed screen refresh frequency of 30 frames per second. In some situations, this might not be enough and mouse movement appears to be jerky. The video panel in the Preferences window has a "Smooth Mouse Tracking" box that raises the video refresh frequency to 60 frames while you are moving the mouse, and then falls back to 30f/s when the mouse rests.
  280.  
  281.  
  282. Copying Content of Video Window
  283.  
  284. The "Copy" menu item allows you to copy the current display to the Mac's clipboard:
  285.  
  286. • if the video window is in graphics mode, choosing "Copy" will put a PICT into the clipboard
  287. • if either 40 or 80 columns text mode is active, "Copy" makes the ASCII text available through the clipboard.
  288.  
  289.  
  290.  
  291. Working with Disks
  292.  
  293. Virtual disks seem to be a confusing concept to some users new to emulators. Since we want to keep this document small and thus dispense with pictures and illustrations, we have added a tutorials section to our web site. Please point your browser at http://www.magnet.ch/emutech/Support/ for step-by-step instructions on basic procedures such as creating a disk image and installing GS/OS onto a virtual disk.
  294.  
  295. Formats Supported
  296.  
  297. Bernie supports various disk formats:
  298.  
  299. • DiskCopy
  300.  
  301. Disk Copy is a popular disk copier from Apple Computer. Disk images created with Disk Copy are compatible with Bernie.
  302.  
  303. • CoolMedia
  304.  
  305. Bernie's own disk format. CoolMedia is compatible with Harddrive images ('hdrv'). With the introduction of Warp 4, you can no longer create new CoolMedia images. However, Bernie will stay backward compatible with your existing CoolMedia disks.
  306.  
  307. • "Real" disks
  308.  
  309. Bernie can read and write disks you insert into the Mac's built-in SuperDrive. You need not install PC Exchange for this as the emulator is accessing disks on a pretty low level. The physical layout of the disk does not matter - actually, Bernie processes Prodos, HFS and MS-DOS disks.
  310.  
  311. • "New Disk Image"
  312.  
  313. There's a new disk image format that will work with most regularly updated emulators across all platforms. Warp 4 can read, write and create so-called "2img" disk images.
  314.  
  315. Disk images can be of virtually any size. The CleverPort (Bernie's SmartPort emulation) can work with disk images ranging from 512 bytes to several gigabytes.
  316.  
  317.  
  318. Mounting Disk Images & Volumes
  319.  
  320. Bernie maintains a dynamic chain of up to 8 SmartPort devices. When mounting a new disk image, Bernie allocates the lowest-numbered free device. To mount a new disk, choose "Mount Volume" from the Setup menu or push the "mount" button in the Volumes window. 
  321.  
  322. Disks inserted into the built-in Superdrive need not be mounted. Bernie will check for a disk in the internal 3.5"drive automatically.
  323.  
  324. Beta 3 introduces Volume Sharing, a feature that allows you to mount an entire volume. Since there are some technical issues to keep in mind, we have put the description of volume sharing into a separate file. Please see the document "MUST READ • Volume Sharing". This document contains crucial information, so please take the time to read it. Thank you!
  325.  
  326. With Warp 4, you can now mount folders. Bernie will attempt to mount all disk images within that folder. Additionally, it will auto-type (i.e. adjust incorrect file types) "2img" disks with non-standard file types. Since Bernie does resolve aliases, you can easily make worksets by creating a new folder and placing aliases of disks (or originals) into it. To mount all the disks in that particular folder, just drop the folder on the Bernie icon or push the "Accept" folder in the "Mount Disk" file dialog. 
  327.  
  328. If you need to mount the same disk image or workset each time you launch Bernie, you can define a startup image or workset. Choose "Select Startup" from the Setup menu and locate your favorite startup disk image or workset. Typically, you will want to define a GS/OS 6.0.1 disk image as your startup volume.
  329.  
  330.  
  331. Rearranging the Device Chain
  332.  
  333. You can remap a CleverPort device to another logical unit at any time.
  334.  
  335. WARNING: remapping a drive may severely confuse the system software. Furthermore, if there are still disk caches with data not written to disk, the disk image may become corrupted. We strongly recommend you to remap devices only during startup, after shutdown, or while working with Prodos 8.
  336.  
  337. To remap a drive, follow these steps:
  338. • open the Volume window (open the Windows menu and choose "Volumes")
  339. • click the drive you'd like to move to another unit
  340. • click the green up or down buttons at the bottom of the window until it arrived at the right position.
  341.  
  342.  
  343. Unmounting/Ejecting a Volume
  344.  
  345. To eject a volume, you have the following options:
  346.  
  347. If you're in the Finder:
  348.  
  349. • Drag the disk into the trash. This flushes disk buffers and ensures data integrity.
  350.  
  351. If you're not in the Finder:
  352.  
  353. • Click the drive's eject button in the Volumes window. Each disk icon has a fully functional eject button to the right of the disk slot. Clicking this small grey box ejects the disk.
  354. • Select a device by clicking the disk icon. A selected CleverPort device has a red frame and a red title. Then push the "eject" button at the bottom of the Volumes window.
  355. • Choose "Eject" from the Setup menu to eject a disk in the internal Superdrive.
  356. • Choose "Eject More.." and select one or more devices to eject
  357.  
  358. As you can see above, there are several ways how to eject a disk or disk image.
  359.  
  360.  
  361. Booting
  362.  
  363. When booting, Bernie scans the device chain for bootable disks. If there's no bootable disk in unit 1, the software scans all mounted disks and swaps the lowest-numbered bootable disk with the one in unit 1. For example, if Bernie finds a system software disk in unit 4, it swaps units 1 and 4 and then continues booting from unit 1.
  364.  
  365.  
  366. Creating New Volumes
  367.  
  368. The menu item "Create Volume" allows you to create new disk images of type "2img", a disk image format readable by most regularly updated emulators. These disks can have virtually any size. Keep in mind that ProDOS does not work with volumes larger than 32Mb.
  369.  
  370.  
  371. Limitations of the CleverPort Disk Interface
  372.  
  373. Bernie does not support direct, low-level IWM access. The IWM is a disk controller (sort of) built into the Apple IIgs. Software that depends on the availability of the IWM will not run. This includes only very few software titles, notably demos from the FTA and similar groups. IWM emulation is mostly completed and has been disabled in this beta release. Upcoming releases of Bernie will allow you to run these software titles. We expect a read-only implementation of the IWM soon.
  374.  
  375. Fast Eddie does not support 5.25" disk hardware. The corresponding code is being worked on.
  376.  
  377. Although Bernie can read, write and create "2img" disk images, not all images created by other emulators can be processed. That's because this type supports serveral data encodings, and some are specific to the disk hardware (IWM emulation). Bernie can handle all images with ProDOS-order disk data which should account for the vast majority.
  378.  
  379.  
  380. Ensoniq Sound Emulation
  381.  
  382. Bernie features rich, 32 channel stereo/surround sound. The emulator emulates the Ensoniq sound chip for the ultimate sound experience with many games and music software.
  383.  
  384. Sound emulation can be customized to make efficient use of your Mac hardware. To fine-tune the sound component, open the Preferences window (open the Setup menu) and click the topmost icon.
  385.  
  386. Sound emulation on/off enables or disables sound emulation. Note that sound emulation requires quite some CPU resources - you should turn it off if you do not need it at the moment or activate the SonicSense feature (see below).
  387.  
  388. The playback mode lets you choose among various settings. Mono outputs a mono signal and is the fastest mode requiring only a fair amount of CPU resources. Stereo provides you with a stereo outpout if your Mac can reproduce two channel sound. If you are connecting headphones, we recommend you to choose Stereo Enhanced - this mode reduces the stereo effect for more relaxed listening with headphones. Dolby Surround is Bernie's state-of-the-art surround sound engine. If you have your Mac connected to a Dolby Pro Logic/THX decoder/preamplifier, this mode outputs 4 channel surround sound (left, right, center, rear). Unfortunately, in order to hear sounds on the center and rear channels, Apple IIgs software must be capable of addressing more than just the standard two stereo channels. See below for information on "Rear Channel Automapping".
  389.  
  390. There are three Volume settings that allow you to increase output volume by a factor of two or three. If you increase volume, you may experience audible scratches in rare situations, namely when all active oscillators are playing very loud. This is due to amplitude clipping.
  391.  
  392. The Xtra Features are a collection of unique functions that make Bernie a top performer:
  393. • SonicSense is a special feature that cuts down sound emulation overhead to an absolute minimum. You should always enable SonicSense. Basically, it means that sound is turned off automatically after 2 seconds of silence and restarted when sound resources are being used again. When sound is turned off by SonicSense, the red light in the "Sound" window is blinking.
  394. • Hi-Fi sound lets you choose between 22kHz (off) and 44Khz (on). Typically, 22kHz is sufficient as the Ensoniq can't play much higher anyway (thanks to a roll-off filter that has a limit of ca. 26kHz).
  395. • Smart Voice Cancelation is a technique for cutting down the number of voices. Often two of the possible 16 pairs of voices can be translated into only one Mac voice, thus this feature can reduce sound emulation overhead by as much as 50% (maximum gain).
  396. • Rear Channel Automapping screens the sounds played tru the Ensoniq and dynamically maps certain voices to the rear and center channels. This option is only active when used with Dolby Pro Logic sound mode. It allows you to listen to surround sound even if the Apple IIgs software is designed to play stereo only. This is an experimental feature and may not always produce 'good' sound. Check it out!
  397. • Delayed Amplitude Scaling prevents abrupt changes in volume. The output volume is "sticky" for a short time and then only gradually adapts to new volume levels.
  398.  
  399.  
  400. Recommendations
  401.  
  402. Sound emulation may slow down Bernie on low-end Power Macs significantly. For best perfomance, be sure to:
  403. • enable SonicSense and Smart Voice Cancelation
  404. • use Mono playback
  405. • close the Sound window
  406. • we have found that Macs are somewhat faster when the Mac (not Bernie!) is set to 44kHz: open the Sound control panel and set "Sound Out" to 44Khz.
  407. • the Sound window (see Window menu) displays some fancy controls. However, opening this window eats valuable CPU resources, so better close it when speed is critical.
  408.  
  409.  
  410. Limitations of Sound Emulation
  411.  
  412. The n•sonic sound driver does not support:
  413. • A/D conversion (for digitizing sounds)
  414. • read data register (this feature is only used by the MIDI toolset as far as we know)
  415.  
  416. Bernie does not support 1-bit sound found in Apple II software. Coming soon.
  417.  
  418.  
  419. Miscellanous
  420.  
  421. Bernie requires your Mac to be in 256 colors.
  422.  
  423. The Preferences window contains a Generic Settings panel. To access it, open the Preferences window and click the third icon button (a IIgs with a yellow ruler). Here's a short description of what some more obnoxious items do:
  424.  
  425. • Special Sound Effects enables "sounds" the Apple IIgs makes, for example when a disk is ejected.
  426. • Power Mode is a special video mode where Bernie takes over your monitor. On larger monitors, it'll add a black border. Power Mode results in noticeable increase in performance. It not only makes your Mac look like a Apple IIgs but also squeezes the last clock cycles out of your PowerPC.
  427.  
  428. Speedup-Tips summary
  429.  
  430. • Close other applications, close Finder windows
  431. • Disable all extensions (shift-boot your Mac)
  432. • Hide the "Sound" window and choose mono, or disable sound.
  433. • Use the option "Power Mode" - video will be drawn directly into video memory.
  434.    Remember the shortcut command-shift-P!
  435.  
  436.  
  437.  
  438.  
  439.  
  440. Enjoy!
  441.  
  442. F.E.Systems
  443. emutech@magnet.ch
  444.  
  445.  
  446.  
  447. Mac, Apple IIgs, SmartPort, GS/OS, Finder, MacOS, ProDOS, AppleWorks are trademarks of  Apple Computer Inc. Dolby Pro Logic is a trademark of Dolby Laboratories Inc. THX is a trademark of Lucasfilm Inc. All other brand names are trademarks of their respective holders.
  448.  
  449.  
  450.